dividir.gastos                package:unknown                R Documentation

Divide igualmente gastos compartilhados durante um perodo por duas ou mais pessoas.

Description:

     A funo  uma ferramenta para resolver divises de gastos entre grupos de pessoas que 
compartilham eventuais gastos durante um perodo, como viagens, festas, churrascos e 
eventos em geral. Utilizando um data.frame contendo os gastos efetuados por cada pessoa, 
a categoria do gasto e a data, calcula as transaes que devem ser feitas para que as contas 
possam ser equilibradas aps o trmino do perodo. Como opo,  possvel plotar grficos 
(gastos cumulativos, gastos por categoria e gastos por pessoa) e realizar converses de 
moedas(real, dolar e euro).

Usage:

     dividir.gastos=function(x, moeda.entrada="real", moeda.saida="real", graficos=TRUE)

Arguments:

       x    	data.frame contendo os eventos de gastos nas linhas, contendo 
                os valores pagos pelas pessoas discriminadas nas colunas. Nas 
                primeiras colunas devem constar as pessoas e seus nomes no 
                cabealho. A penltima coluna deve se chamar "categoria" e 
                deve conter as categorias de cada gasto (character). A ltima 
                coluna deve se chamar "data" e conter as datas dos respectivos
                gastos, em formato dd/mm/yy. 

 moeda.entrada  a moeda correspondente aos valores apresentados em x. Pode ser
                "real"(default), "dolar" ou "euro".

  moeda.saida	a moeda que se deseja na devoluo dos valores pela funo.
                Pode ser "real" (default), "dolar" ou "euro".

   graficos	argumento lgico. Se TRUE(default), habilita a plotagem dos
                grficos da funo. Se FALSE, desabilita a plotagem.



Details:

     Os nomes das pessoas devem estar explicitados no data.frame como cabealho, assim 
como 
     a penltima e ltima colunas devem ter como cabealho "categoria" e "data", 
respectivamente
     (e conter tais dados, obrigatoriamente).
     
     Regras para o preenchimento dos valores no data.frame: em cada linha, valores de 
gastos efetuados
     sero colocados de acordo com a pessoa que gastou. Pessoas que efetuaram de fato um 
gasto recebem 
     o valor do gasto efetuado. Pessoas que participam do consumo mas no gastaram no ato 
recebem o 
     o valor zero. E por fim, pessoas que no participam do consumo daquele gasto devem 
receber NA. 

Value:

     A funo retorna uma matriz de pagamentos. Para saber se uma pessoa deve pagar algo 
a outra,
     basta olhar na linha que contm seu nome. Nas colunas estaro dispostos os valores que 
essa
     pessoa deve pagar a todas as outras. Se ela no deve nada, o valor  zero.

Warning:

     Caso os parmetros especificados para o data.frame no esteja corretamente 
preenchidos, a funo
     no ir funcionar corretamente.

Author(s):

     Gabriel Massami Kayano

References:

   Google Finance Converter  
     https://www.google.com/finance/converter

Examples:

## Exemplo 1 : diviso de gastos sem plotagem e sem converso de moeda
# criando data.frame com os dados:
exemplo1=read.table("exemplo1.csv", header=TRUE, sep=",", as.is=TRUE)
# aplicao da funo com graficos=FALSE e moeda.entrada=moeda.saida
dividir.gastos(exemplo1, graficos=FALSE)

## Exemplo 2: diviso de gastos com plotagem e sem converso de moeda
# criando data.frame com os dados:
exemplo2=read.table("exemplo2.csv", header=TRUE, sep=",", as.is=TRUE)
# aplicao da funo com graficos=TRUE
dividir.gastos(exemplo2, graficos=TRUE)

## Exemplo 3: diviso de gastos com plotagem e com converso de moeda (BRL-USD)
# criando data.frame com os dados:
exemplo3=read.table("exemplo3.csv", header=TRUE, sep=",", as.is=TRUE)
# aplicao da funo com graficos=TRUE
dividir.gastos(exemplo3, moeda.entrada="real", moeda.saida="dolar", graficos=TRUE)



